package cn.epsilon3.mybatis.mapper;

import cn.epsilon3.domain.e3.dto.query.E3ResourceQuery;
import cn.epsilon3.domain.e3.po.E3ResourcePO;
import cn.epsilon3.domain.e3.vo.E3ResourceVO;
import cn.epsilon3.mybatis.base.Epsilon3SupportMapper;
import org.apache.ibatis.annotations.Param;
import org.springframework.data.domain.Pageable;

import java.util.List;

/**
 * 菜单资源(E3ResourcePO)表数据库访问层
 *
 * @author Epsilon3
 * @since 2023/11/12 21:49
 */
public interface E3ResourceMapper extends Epsilon3SupportMapper<E3ResourcePO> {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    E3ResourcePO queryById(String id);

    /**
     * 查询指定行数据
     *
     * @param e3ResourcePO 查询条件
     * @param pageable         分页对象
     * @return 对象列表
     */
    List<E3ResourcePO> queryAllByLimit(E3ResourcePO e3ResourcePO, @Param("pageable") Pageable pageable);

    /**
     * 统计总行数
     *
     * @param e3ResourcePO 查询条件
     * @return 总行数
     */
    long count(E3ResourcePO e3ResourcePO);

    /**
     * 新增数据
     *
     * @param e3ResourcePO 实例对象
     * @return 影响行数
     */
    int insertOne(E3ResourcePO e3ResourcePO);

    /**
     * 批量新增数据（MyBatis原生foreach方法）
     *
     * @param entities List<E3ResourcePO> 实例对象列表
     * @return 影响行数
     */
    int insertBatch(@Param("entities") List<E3ResourcePO> entities);

    /**
     * 批量新增或按主键更新数据（MyBatis原生foreach方法）
     *
     * @param entities List<E3ResourcePO> 实例对象列表
     * @return 影响行数
     * @throws org.springframework.jdbc.BadSqlGrammarException 入参是空List的时候会抛SQL语句错误的异常，请自行校验入参
     */
    int insertOrUpdateBatch(@Param("entities") List<E3ResourcePO> entities);

    /**
     * 修改数据
     *
     * @param e3ResourcePO 实例对象
     * @return 影响行数
     */
    int update(E3ResourcePO e3ResourcePO);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(String id);

    /**
     * 查询各个角色对应的资源
     *
     * @param roleId 角色id
     * @return 可达资源反参
     */
    List<E3ResourceVO> queryRoleResource(@Param("roleId") String roleId);

    /**
     * 查询各个角色对应的功能资源权限集合
     *
     * @param roleId 角色id
     * @return 功能资源权限集合
     */
    List<String> queryRoleResourceOfF(@Param("roleId") String roleId);

    /**
     * 条件查询资源
     *
     * @param resourceQuery 查询条件
     * @return 资源树
     */
    List<E3ResourceVO> list(E3ResourceQuery resourceQuery);
}

